home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / ps50.zip / PS.DOC < prev    next >
Text File  |  1991-08-28  |  75KB  |  1,613 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    P S E A R C H
  9.  
  10.  
  11.  
  12.                              -------------------------
  13.                              Users Guide and Reference
  14.                              -------------------------
  15.  
  16.  
  17.  
  18.  
  19.                                     Version 5.0
  20.                                     August 1991
  21.  
  22.  
  23.  
  24.  
  25.                                           ┌─────────┐
  26.                                     ┌─────┴───┐     │              (tm)
  27.                                     │         │o    │──────────────────
  28.                                     │   ┌─────┴╨──┐ │  Association of
  29.                                     │   │         │─┘  Shareware
  30.                                     └───│    o    │    Professionals
  31.                                     ────│    ║    │────────────────────
  32.                                         └────╨────┘    * Member *
  33.  
  34.                                Patri-Soft
  35.  
  36.                           (714) 352-2820 (Voice)
  37.                           (714) 352-2825 (BBS)
  38.                           (714) 352-1527 (FAX)
  39.  
  40.               Copyright 1986, 1987, 1988, 1989, 1990, 1991 by Patri-Soft
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.      PSEARCH Users Guide/Reference                Copyright 1991 Patri-Soft
  48.      ----------------------------------------------------------------------
  49.  
  50.                                Table of Contents
  51.  
  52.  
  53.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . .   1
  54.      Features. . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  55.      Patri-Soft in the Press . . . . . . . . . . . . . . . . . . .   3
  56.      Using PSEARCH . . . . . . . . . . . . . . . . . . . . . . . .   4
  57.         Using PSEARCH Menu Mode. . . . . . . . . . . . . . . . . .   4
  58.            Function Selection Menu . . . . . . . . . . . . . . . .   4
  59.            Text Search Entry Display . . . . . . . . . . . . . . .   6
  60.            File Name Search Entry Menu . . . . . . . . . . . . . .   7
  61.            Special Editing Functions . . . . . . . . . . . . . . .   8
  62.            Advanced Options Entry Menu . . . . . . . . . . . . . .  10
  63.            PSEARCH output data display . . . . . . . . . . . . . .  10
  64.            Scrollback. . . . . . . . . . . . . . . . . . . . . . .  11
  65.         PSEARCH Command Line Mode. . . . . . . . . . . . . . . . .  12
  66.            Command Parameters. . . . . . . . . . . . . . . . . . .  12
  67.         Setting Default parameters in the DOS Environment. . . . .  26
  68.      Screen Colors and Monitor Support . . . . . . . . . . . . . .  26
  69.      Pausing the Search. . . . . . . . . . . . . . . . . . . . . .  26
  70.      Maintenance History . . . . . . . . . . . . . . . . . . . . .  27
  71.      Registering PSEARCH and other Patri-Soft Utilities. . . . . .  31
  72.      Site Licenses . . . . . . . . . . . . . . . . . . . . . . . .  31
  73.      VISA/MasterCard Telephone Registration Orders . . . . . . . .  32
  74.      
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                      i
  93.  
  94.  
  95.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  1
  96.      --------------------------------------------------------------------
  97.  
  98.      Introduction
  99.      ------------
  100.  
  101.      PSEARCH lets you easily locate lost or forgotten files on hard
  102.      disks or diskettes.  Since hard disk technology has made 70, 80,
  103.      150 megabyte, and larger hard disks commonplace, users keep more
  104.      information than ever stored in their PC systems.  It is not
  105.      uncommon for users to have over 2000 files on their hard disks.
  106.      This proliferation of files makes it very difficult to store files
  107.      with names and directory structures that can be easily remembered
  108.      and retrieved when files are later needed.
  109.  
  110.      When you need to find a file on your disk but do not know its
  111.      filename or even directory, you most always know something unique
  112.      about this file. If not, you would probably not be searching for
  113.      it.  This unique information might me a person's name, a product
  114.      name, a type of process, or even a location.  Whatever it is,
  115.      PSEARCH can take this information and use it to search all files on
  116.      the disk to identify one or more files that contain this unique
  117.      data.
  118.  
  119.      Since PSEARCH can reduce your search from a list of 2000 files to
  120.      just a few files, your job of locating a file becomes effortless.
  121.      Quick examination of a few files easily lets you know if the
  122.      desired file is on your disk.
  123.  
  124.      PSEARCH users have saved thousands of dollars in time searching for
  125.      files, and time that would have been used to recreate lost files.
  126.      PSEARCH becomes a invaluable tool for all hard disk users.
  127.  
  128.      PSEARCH goes farther than searching for data. Once files are found,
  129.      you can automatically invoke other DOS programs and utilities to
  130.      process them.  PSEARCH becomes a powerful driver for other programs.
  131.  
  132.      In addition to being flexible, PSEARCH is fast!  Our review of
  133.      available text search utilities showed PSEARCH to be the best
  134.      performer.  Our advanced search algorithm combined with
  135.      flexible selection and exclusion criteria insure PSEARCH can
  136.      find your files in the fastest possible time.
  137.  
  138.      PSEARCH has functions and features that make it useful in many
  139.      different situations.  After reviewing this documentation and use
  140.      PSEARCH, we are confident you will find a permanent place for it in
  141.      your arsenal of tools.
  142.  
  143.  
  144.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  2
  145.      --------------------------------------------------------------------
  146.  
  147.      Here are a list of some of the many possible uses for PSEARCH.
  148.  
  149.      **   List all files on a hard disk that match a wildcard
  150.           specification.
  151.  
  152.      **   Show the names of any files containing specified text
  153.  
  154.      **   Show text lines of any file containing a specified string.
  155.  
  156.      **   Scroll back and forward through search results                 |
  157.  
  158.      **   View text and WordPerfect files directly from scroll display   |
  159.  
  160.      **   Look for word "Mrs" in any file and preserve case in search.
  161.  
  162.      **   Find 123 files containing the word "BUDGET" and print their name.
  163.  
  164.      **   Compile all C programs that refer to the "RECDESC.H" include
  165.           file.
  166.  
  167.      **   Find a word processing document containing the name "Wiffle".
  168.  
  169.      **   Delete any *.DOC files containing "To: Mr. Johnson".
  170.  
  171.      **   Locate all readonly files existing on a disk.
  172.  
  173.      **   List all files updated today.
  174.  
  175.      **   Build a DOS command to archive manually selected files from one
  176.           or more directories.
  177.  
  178.      **   Search multiple drives attached to the system for text or a file
  179.           name
  180.  
  181.      **   Search for a file name even if it has been archived into .ZIP,
  182.           .ARC or .LZH formats.
  183.  
  184.      **   Limit text search to WORDS, PREFIXES, or SUFFIXES. This greatly
  185.           enhances the search by returning only the data you want.
  186.  
  187.      **   Exclude files from the search process to improve performance.
  188.  
  189.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  3
  190.      --------------------------------------------------------------------
  191.  
  192.      Patri-Soft in the press!
  193.      ------------------------
  194.  
  195.      "Fast and Safe File Copying --
  196.          DOS's COPY command is a sorry imitation of a real utility       |
  197.          and at times causes far more trouble than its worth.  How       |
  198.          many times have you copied a file only to find out the new      |
  199.          file you created has written over a file that has the same      |
  200.          name?                                                           |
  201.  
  202.          PCOPY won't let that happen.  It warns you when you are         |
  203.          about to overwrite and existing file and asks you whether       |
  204.          you want to rename the file, stop the operation, or go          |
  205.          ahead and overwrite the file.  That's just one of this          |
  206.          handy utility's many features."                                 |
  207.  
  208.                               PC Computing, July 1991                    |
  209.                               "Tame Your Hard Disk"                      |
  210.                               Preston Gralla                             |
  211.      ---------------------------------------------------------------
  212.       "PCOPY is an extremely effective and efficient utility for         |
  213.       copying and moving files.  It provides options that no other       |
  214.       utility offers.  It also makes copying, simple, fast, and          |
  215.       perhaps most importantly, safe."                                   |
  216.  
  217.                      Dr. File Finder's Guide to Shareware                |
  218.                             Mike Callahan and Nick Anis - 1990           |
  219.      ---------------------------------------------------------------
  220.       "PCOPY is a greatly enhanced version of the DOS COPY               |
  221.       command..."                                                        |
  222.  
  223.                      MS-DOS Utility Programs                             |
  224.                             Ronnie Richardson - 1989                     |
  225.      ---------------------------------------------------------------
  226.       "Patriquin offers his entire line of utilities for $45.  Since     |
  227.       we think some of the programs he's asking $15 for are worth        |
  228.       more, we highly recommend the package option.  Even if you         |
  229.       don't end up using all the utilities, you will receive a great     |
  230.       collection of programs for a great price,..."                      |
  231.  
  232.                      Public-Domain Software & Shareware                  |
  233.                            Rusel DeMaria and George R. Fontaine 1988     |
  234.      ---------------------------------------------------------------
  235.       "PCOPY a superior way to copy files..."                            |
  236.  
  237.                      Shareware Magazine - Dec 1990                       |
  238.      ---------------------------------------------------------------
  239.  
  240.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  4
  241.      --------------------------------------------------------------------
  242.  
  243.  
  244.      Using PSEARCH
  245.      -------------
  246.  
  247.      PSEARCH may be executed directly from the DOS prompt or using menus
  248.      that guide you through the process of entering search
  249.      specifications.  Both techniques use the same 'PS' command. PSEARCH
  250.      determines the difference in modes by the presence or absence of
  251.      command line parameters.  When no command parameters are used, menu
  252.      operation is selected.
  253.  
  254.  
  255.      Using PSEARCH Menu Mode
  256.      -----------------------
  257.  
  258.      To start PSEARCH using the menu mode, enter the PS command at the
  259.      DOS prompt and press the <Enter> key.  The following menu will
  260.      be displayed...
  261.  
  262.  
  263.      --------------------------------------------------------------------
  264.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  265.                                                                                 
  266.                     F U N C T I O N   S E L E C T I O N                         
  267.                                                                                 
  268.             Select the PSEARCH activity you want to perform...                  
  269.                                                                                 
  270.                                                                                 
  271.                  Text Search.  Find Files Containing Text                       
  272.                  Name Search.  Find Files using name patterns
  273.                  View          Review previous search results            |
  274.                  Help                                                           
  275.                  Exit to DOS                                                    
  276.                                                                                 
  277.  
  278.      --------------------------------------------------------------------
  279.                              PSEARCH Main Menu
  280.  
  281.  
  282.      The PSEARCH menu provides entry to PSEARCH processing.  Menu items
  283.      may be selected by using an highlight bar positioned over the first
  284.      menu item when PSEARCH is started.  Use the cursor arrow keys to
  285.      move the the highlight bar to the function desired and press the
  286.      <Enter> key to start the action.  You may quickly select any item
  287.      by pressing the key relating to the first character of the menu
  288.      item.  For example, press <N> to start a file name search.
  289.  
  290.    
  291.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  5
  292.      --------------------------------------------------------------------
  293.  
  294.      Following is a description of each menu item:
  295.  
  296.      Text Search.  Activates PSEARCH's text search facility.  You will
  297.                    be presented with a entry menu to allow you to enter
  298.                    specifications PSEARCH is to use to search for data.
  299.  
  300.                    Text Search is PSEARCH's ability to search within
  301.                    files to find specific text.  It allows you to
  302.                    automatically scan you systems disks to locate files
  303.                    containing specific data contents.  For example, you
  304.                    can find all files on the system that contain the
  305.                    name 'Jones'.
  306.  
  307.      Name Search.  Activates the Name search facility.  Name search
  308.                    allows you to use PSEARCH to locate files on your
  309.                    system by the contents of their file names.
  310.  
  311.                    The DIR command provied with DOS only allows you to
  312.                    locate files within any one single directory.  When
  313.                    you have many directories and maybe even multiple
  314.                    hard disks, it becomes impracticle to use the DIR
  315.                    command to locate a file when you do not know what
  316.                    directory it exists in.
  317.  
  318.                    PSEARCH name search can automatically search all
  319.                    directories and even all disk devices to find a
  320.                    specific or pattern file name.
  321.  
  322.      View          Search output from the previous execution of PSEARCH  |
  323.                    is saved in file PS.SBK.  You may review previous     |
  324.                    search results by selecting the View option from the  |
  325.                    menu or by specifying the /V command line option.     |
  326.  
  327.                    This options saves you time by preventing you from    |
  328.                    having to reexecute a search to see search results    |
  329.                    after exiting PSEARCH.                                |
  330.  
  331.                    When viewing search results you may place the View    |
  332.                    scroll bar within the output for any filename and     |
  333.                    view that file contents.  Up to 1000 lines of output  |
  334.                    are displayed.  Press <Escape> to exit file viewers.  |
  335.  
  336.      Help          PSEARCH's command line help provides very complete
  337.                    help information on all of PSEARCH's facilities. The
  338.                    help is provided primarily for those that want to use
  339.                    PSEARCH's command line mode of operation but is
  340.                    useful for all to use as a quick reference of
  341.                    PSEARCH's abilities.
  342.  
  343.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  6
  344.      --------------------------------------------------------------------
  345.  
  346.                    PSEARCH help consists of several pages of scrollable
  347.                    data.  When you exit the help, you will be returned
  348.                    to PSEARCH's main menu.
  349.  
  350.      Exit to DOS.  You may exit PSEARCH menu mode by either selecting
  351.                    the Exit menu item or by simply pressing the <ESCAPE>
  352.                    key from menu mode.
  353.  
  354.                    Upon exiting, PSEARCH will display how long it has
  355.                    been active and provide a summary of its results.
  356.  
  357.      The Text Search Entry Display
  358.      -----------------------------
  359.  
  360.      The following display is shown as a result of selecting the Text
  361.      Search option from PSEARCH's main menu.  It allows you to enter
  362.      specifications indicating the data PSEARCH is to locate.
  363.  
  364.      --------------------------------------------------------------------
  365.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  366.  
  367.                            Text Search Specification
  368.  
  369.       Path to Search: _______________________________________________
  370.  
  371.       Text(1): _____________________________________________
  372.       Text(2): _____________________________________________
  373.       Text(3): _____________________________________________
  374.       Text(4): _____________________________________________
  375.       Text(5): _____________________________________________
  376.  
  377.        __ Match All?   (Y=All Text must be found  N=Find any matches)
  378.        __ Search Directories  (blank=Current S=System(all)  P=Path only)
  379.        __ Exclude files and directories entered in PSEARCHT.EXC?
  380.        __ Case Sensitive Search? (Y=Match exact text   N=Ignore case)
  381.        __ Qualify (blank=none W=Find Word  P=Prefix S=Suffix)
  382.        __ Showing found text? (Y=ALL N=none F=First match R=Related Text)
  383.        __ Show linenumbers for found text? (Y/N)
  384.        __ Stop scrolling when display full (Y/N)
  385.        __ Pause on each found match?
  386.        _____    For multiple drive search drives to search
  387.        _____    If multiple text, text must within n characters
  388.  
  389.      Keys:  <F3> DOS      <F9> Advanced Options        <F10> Start Search
  390.      --------------------------------------------------------------------
  391.                             Text Search Entry Menu
  392.  
  393.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  7
  394.      --------------------------------------------------------------------
  395.                             
  396.      See the command parameter portion of this document for a complete
  397.      description of all the parameters you are allowed to specify on
  398.      this display.
  399.  
  400.      Once all data is entered, you may immediately start the search by
  401.      pressing the <F10> key, or may specify advanced search options by
  402.      pressing the <F9> key.  The advanced options entry menu allows
  403.      further specifications to be made.  You may use the <F3> key to
  404.      temporarily exit to a PSEARCH window to execute DOS commands. You
  405.      may enter any DOS command in this window.
  406.  
  407.      The F10 key may be pressed from any location on this display.  If
  408.      you use the <Enter> key to proceed through each item on the
  409.      display, pressing <Enter> on the last item will begin the search.
  410.  
  411.      All specifications on this display except for pathname and search
  412.      text are maintained in a special PSEARCH control file. This file
  413.      (PS.DAT) is created the first time you run PSEARCH and is
  414.      placed in the same directory as the PSEARCH program file (PS.EXE).
  415.      This control file allows PSEARCH to retain your search
  416.      specifications for the next time you use it.
  417.  
  418.  
  419.      The File Name Search Entry Display
  420.      ----------------------------------
  421.  
  422.      The File Name Search Display allows you to enter specifications
  423.      PSEARCH is to use while searching for files by name on your system.
  424.  
  425.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  8
  426.      --------------------------------------------------------------------
  427.  
  428.      --------------------------------------------------------------------
  429.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  430.                                                                                 
  431.                          Find File Specification
  432.                                                                                 
  433.         Path to Search: ____________________________________________
  434.                                                                                 
  435.                                                                                 
  436.                                                                                 
  437.        __  Search Directories (blank=Current S=System(all) P=Path only)
  438.        __  Exclude files and directories entered in PSEARCHF.EXC?
  439.        __  Search Archived Files (ZIP/ARC/LZH)? (N=none A=Yes B=Both)
  440.        __  Stop scrolling when display full (Y/N)
  441.        __  Pause on each found match?
  442.        __  Flex Search:  =none  S=Sound like  V=NoVowels  C=CharsOnly
  443.  
  444.        _____     For multiple drive search, letter of drives
  445.  
  446.  
  447.  
  448.                                                          
  449.                                                                                 
  450.      Keys:  <F3> DOS       <F9> Advanced Options       <F10> Start Search
  451.      --------------------------------------------------------------------
  452.  
  453.  
  454.      This entry screen works like the Text Entry display discussed earlier.
  455.      See the command parameter descriptions for more information about the
  456.      parameters you may enter.
  457.  
  458.  
  459.      Special Editing Functions
  460.      -------------------------
  461.  
  462.      Special edit functions are provided to enhance your capability
  463.      to specify DOS pathname and text specifications.  These following
  464.      features are available on all specification entry screens.
  465.  
  466.         Field Edit  --  You are presented with pathname and text
  467.                         specifications from prior executions on the
  468.                         parameter input displays.  You may use the
  469.                         shown value by simply pressing <Enter>.
  470.  
  471.                         You may change the value by first pressing a
  472.                         field edit key such as left or right cursor
  473.                         arrow, <INS>, or <DEL>.  Then you may edit
  474.                         the field as desired.
  475.  
  476.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page  9
  477.      --------------------------------------------------------------------
  478.  
  479.                         Entering any other value causes the current
  480.                         field to disappear and to be replaced by the
  481.                         keyed in value.
  482.  
  483.         Restore Field   Press alt-X when you are editing a field to
  484.                         restore it to its original value.
  485.  
  486.         Lower Case      Press alt-L to convert all characters in the
  487.                         field to lower case.
  488.  
  489.         Upper Case      Press alt-U to convert all characters in the
  490.                         field to upper case.
  491.  
  492.         Captialize      Press alt-C to cause all words in the field to
  493.                         be capitalized and other characters to be changed
  494.                         to lower case.
  495.  
  496.         Reverse         Press alt-R to reverse the characters in the
  497.                         in the field (first=last and last=first).
  498.  
  499.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 10
  500.      --------------------------------------------------------------------
  501.  
  502.      Advanced Options Entry Display
  503.      ------------------------------
  504.  
  505.      The Advanced Options Entry Display allow specification of advanced
  506.      options to be used for both Text and File name searches.  These
  507.      options are not necessary for PSEARCH to function and may be
  508.      ignored if desired.
  509.  
  510.  
  511.      --------------------------------------------------------------------
  512.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  513.                                                                                 
  514.                           Advanced Options Screen                               
  515.                                                                                 
  516.        __ Print and Display all results? (Y/N)
  517.        __ Log and Display all results? (Y/N)    Log file PSLOG.TXT
  518.        ____  Files Attributes U=Updated H=Hidden S=System R=Readonly
  519.  
  520.           For each matching file PSEARCH can generate and optionally
  521.           execute any desired command.  Specify the command below:
  522.  
  523.        __ Action?  blank=none  W=Write to PSCMDS.BAT file  X=Execute
  524.                                P=Execute command with pause after each
  525.  
  526.         Execute Command: _____________________________________________
  527.  
  528.           The following characters may be used in the command to
  529.           generate commands with the matching directory and filename.
  530.                &=path  #=Filename  !=File  @=/  ~=Archive name
  531.                For example, to copy all matching files to drive A:
  532.                    Command: COPY & A:
  533.  
  534.  
  535.       Keys:       <F3> DOS           <F10> Start Search
  536.      --------------------------------------------------------------------
  537.                       Advanced Options Entry Screen
  538.  
  539.      See subsequent sections in this document for more information about
  540.      the advanced specifications that may be entered on this display.
  541.      Once all specifications are entered you begin the search by
  542.      pressing the <F10> key on any field, or by pressing the <Enter> key
  543.      from the last entry field on the display.
  544.  
  545.      The PSEARCH Output Data Display
  546.      -------------------------------
  547.  
  548.      The following display is a sample of PSEARCH output as a result of
  549.      a TEXT Search request.
  550.  
  551.  
  552.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 11
  553.      --------------------------------------------------------------------
  554.  
  555.  
  556.      --------------------------------------------------------------------
  557.      PSEARCH - File Searcher                 Copyright 1991 by Patri-Soft
  558.      Searching *.* for (this)  Opt ==> SHOW MULT ANYCASE MORE
  559.      --------------------------------------------------------------------
  560.      Searching *.* files for string (this)
  561.  
  562.      ======> FINANC.LTX       3287  16FEB89  6:42p
  563.      I am unable to determine what happened to this specific order.
  564.      to me.  I may be having trouble with this new address.  I know
  565.      In any case, I have corrected the problem and hope this package
  566.      normally sent to users.  If this is
  567.  
  568.      ======> ENHANREQ.LTR     2733   1MAR89  6:04a
  569.             drives.  This invokes the no⌐window mode.
  570.  
  571.      ======> HUFFMAR          1658  10MAR89  7:35a
  572.             A copy of the agreement is supplied with this
  573.  
  574.      ======> PRINT.TXT        1104   4MAY89  7:47a
  575.             receive no royalties from this product but I have agreed
  576.  
  577.      ======> LTR.LTR          2821   9JUN89  9:54a
  578.             drives.  This invokes the no-window mode.
  579.  
  580.      ** More?  <Enter> for more, <C> for continuous, <ESC> terminate ***
  581.      --------------------------------------------------------------------
  582.      Path(#1) C:\WP                               27  FILE=  WILLAM.BRO
  583.      --------------------------------------------------------------------
  584.                          PSEARCH Output Display
  585.  
  586.  
  587.      The top and bottom portion of the output display are reserved for
  588.      statistical information to keep you aware of what PSEARCH is
  589.      searching during processing.  The center portion of the display
  590.      shows the data found that matches the search specifications.
  591.  
  592.      For each found text match, PSEARCH displays the file name and data
  593.      matching the search criteria.  The filename is shown on a line
  594.      before the matching text.  This line also shows the date and time
  595.      the file was last updated or created and the size of the file in
  596.      characters. If DOS attributes are present in the DOS directory
  597.      entry for the file, they are also shown.
  598.  
  599.      Scrollback and viewing search results                               |
  600.      -------------------------------------                               |
  601.  
  602.      Up to 500 lines displayed during a search are also saved in memory  |
  603.      for later viewing.  When more than 500 lines are generated, only the|
  604.      last 500 lines are maintained in the scroll back list.              |
  605.  
  606.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 12
  607.      --------------------------------------------------------------------
  608.  
  609.  
  610.      The scroll back list may be accessed at any time during PSEARCH     |
  611.      operation.  You may interrupt the search process and then press the |
  612.      Up Arrow key to access the list.  To continue the search, press the |
  613.      escape key to exit view processing.  At this point you can exit     |
  614.      PSEARCH by pressing escape again, or continue searching by pressing |
  615.      any other key.                                                      |
  616.                                                                          |
  617.      When in View scroll mode, use the PgUp, PgDn, Up Arrow, Down Arrow, |
  618.      End, and Home key to scroll through all search output.  You may also|
  619.      press <F3> at any time to execute a DOS command.  When the command  |
  620.      is complete, you may issue another command or return to viewing the |
  621.      search output.                                                      |
  622.                                                                          |
  623.      When searching is complete, PSEARCH automatically puts you in view  |
  624.      scrolling mode.  Pressing escape at this point will end the search  |
  625.      and return to DOS or the menu.                                      |
  626.  
  627.      PSEARCH Command Line Mode
  628.      -------------------------
  629.  
  630.      The following section describes the use PSEARCH using command
  631.      line specifications.  These specifications all you to enter
  632.      all PSEARCH options directly on the PSEARCH command when it is
  633.      entered to DOS.  Although more difficult to master, the command
  634.      line mode is the easiest and fastest to use once you learn how
  635.      to use PSEARCH.
  636.  
  637.  
  638.      Command Parameters
  639.      ------------------
  640.  
  641.      Command parameters control PSEARCH's may different features when it
  642.      is use in command line mode at the DOS prompt. They are easy to
  643.      understand and learn, and provide you need to quickly locate all
  644.      files. Remember that each parameter is summarized in the online
  645.      help display. Just type PS at the DOS promot.
  646.  
  647.  
  648.      COMMAND FORMAT:
  649.  
  650.      PS [fspec] /T:text /F /S /C /P /PR /PF /MO /O:nn/N:nn /NW /TA
  651.                 /X[F][P]:cmd /AT:c /FW /FP /FS /DR:xxx /SO /AR /AO
  652.  
  653.  
  654.      PS - PS is the name of the PSEARCH command.
  655.      PS actually refers to Patriquin's PSEARCH. Enter the command without
  656.      any parameters for menus and help.
  657.  
  658.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 13
  659.      --------------------------------------------------------------------
  660.                                        
  661.      [fspec]
  662.            Enter the DOS file specification for the directory and file
  663.            names to be searched. If no directory name is specified the
  664.            current directory will be searched. If the /S option is
  665.            specified, the directory name portion of this parameter is
  666.            not used.
  667.  
  668.            Like DOS, use the '*' to indicate the last part of a filename
  669.            or filename extension may be any set of characters.  Also
  670.            like DOS, use the '?' to indicate that any single position of
  671.            a filename may be any character.
  672.  
  673.            In addition to DOS, you may place an '*' anywhere in the
  674.            filename to indicate any set of characters may exist in this
  675.            point in the name.
  676.  
  677.  
  678.      SPECIAL FLEX FILENAME SEARCHING CONTROL CHARACTERS
  679.  
  680.            The filename specification may contain a full DOS pathname
  681.            including the standard DOS wildcard characters * and ?. In
  682.            addition the special characters '~', '!', or ';' may be
  683.            placed immediately before the filename to specify special
  684.            filename find criteria.
  685.  
  686.                 ~ SOUNDEX -- Select any filename that sounds like the
  687.                              specified name
  688.                      ~WORD would select:
  689.                             WORD WOOORD WRD WOOD WORLD
  690.  
  691.                 ; NOVOWEL -- Select equal filenames but ignore vowels
  692.                              AEIOU in name
  693.  
  694.                      !WOORD would select:
  695.                             WoRD WoooRD WieRD WRD
  696.  
  697.                 ! CHARS -- Select any filenames that contain the
  698.                            characters entered
  699.                      !WD would select:
  700.                             WorD.dat WilDone.dat lstWorD.x
  701.  
  702.  
  703.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 14
  704.      --------------------------------------------------------------------
  705.                             
  706.            Following are examples:
  707.  
  708.              1.    *.EXE
  709.              2.    TEST*.*
  710.              3.    *TEST*.*
  711.              4.    DO?FIX.*
  712.              5.    PC*XX.*
  713.              6.    C:\DOS\*.*
  714.              7.    \TEST\*.*
  715.              8.    !WD*.*
  716.              9.    ~WORD.*
  717.  
  718.      SPECIFY A LIST OF FILES TO BE SEARCHED
  719.  
  720.             As an alternative, a file containing a list of input files may
  721.             be supplied.  Create  a file containing lines  with a filename
  722.             or complete pathname on  each line.  Provide  this filename as
  723.             the source filename to PSEARCH and add an @ character before the
  724.             name.  The list of files will be processed as if they were all
  725.             specified on the input command line.
  726.  
  727.             For file list processing,  PSEARCH understands the output of the
  728.             DOS DIR command.   You may use the  DOS redirection feature to
  729.             direct DIR output  to a file, edit  the file to add  or remove
  730.             entries,  and  then  provide this  to  PSEARCH  as  input.   For
  731.             example:
  732.  
  733.             DIR \TURBOC\C\*.C > FILE.LST
  734.             PSEARCH @FILE.LST /T:TEXT
  735.  
  736.      /AO   Archive type files Only - If you have files on your system
  737.            that are compressed into archive files with DOS extension
  738.            names of .ZIP, .ARC, or .LZH, PSEARCH is to search only these
  739.            files. This parameter is only useful for file name searching.
  740.            PSEARCH does not decompress these file contents for text
  741.            search requests.
  742.  
  743.            When specified, this parameter specifies that all archive
  744.            files are to be internally searched for filenames compressed
  745.            in them that meed the specified file specification.
  746.  
  747.            Note, you do not specify .ARC, .ZIP, or .LZH in the PSEARCH
  748.            file specification.  PSEARCH will automatically find and
  749.            search these files.
  750.  
  751.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 15
  752.      --------------------------------------------------------------------
  753.  
  754.  
  755.      /AR   ARchive type files as well as normal files -  PSEARCH will
  756.            search both archive files and non-archive files for matching
  757.            filename specifications.  Use only for file name searches.
  758.            (See also the /AO command parameter).
  759.  
  760.  
  761.  
  762.      /AT:c ATtributes - Specifies that PSEARCH is to search for files
  763.            having one or more of the attributes specified by the /AT:
  764.            parameter.
  765.  
  766.                 U - Updated,the ARCHIVE bit is on to indicate the file
  767.                     has been updated since the last backup.
  768.  
  769.                 R - Readonly,Files marked with Readonly attribute.
  770.  
  771.                 H - Hidden,Files marked with Hidden attribute.
  772.  
  773.                 S - System, Files marked with System attribute.
  774.  
  775.            Use /AT:U to locate all files that have been updated since
  776.            your last backup was done.
  777.  
  778.            Use /AT:H to determine what hidden files exist on your
  779.            disks.
  780.  
  781.  
  782.      /C Case - Indicates that text search requests are to be case
  783.            sensitive.  That is, exact upper/lower case searching
  784.            will be done.
  785.  
  786.            Normally it is easier to let PSEARCH find text data
  787.            regardless of its case.  This allows you to be sure to find
  788.            any possible matches.
  789.  
  790.            Exact case searching is useful for those cases where you know
  791.            the text is specified in an exact way.  It potentially
  792.            reduces the number of false matches that may be encountered
  793.            during the search.
  794.  
  795.      /DR:  DRive list. If the drive is not specified in the main
  796.            pathname, PSEARCH will search the current disk device. /DR:
  797.            indicates one or more drives that the search is to be
  798.            performed on. The following example indicates the search is
  799.            to be done on drives C and D.
  800.  
  801.                /DR:CD
  802.      
  803.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 16
  804.      --------------------------------------------------------------------
  805.  
  806.            The drive list is especially useful for searching all drives
  807.            on a system containing multiple hard disks.  Specify this
  808.            parameter in the PSEARCH= environment variable to force it to
  809.            be in effect for all command line executions.
  810.  
  811.  
  812.  
  813.      /DS   Directory path search.  Normally PSEARCH will search only the
  814.            current directory or the entire disk of /S is also specified.
  815.            The /DS parameter indicates PSEARCH is to search the
  816.            specified or current directory and all of its subordinate
  817.            directories for files.
  818.  
  819.            This parameter is useful for those system that have well
  820.            structured hard disk directories.  For example, PSEARCH can
  821.            easily search all word processing directories if all these
  822.            directories are subordinate to a single high level directory
  823.            name.
  824.  
  825.            If you have a directory structure like the following...
  826.  
  827.                C:\                    Root directory
  828.                C:\WPSYS\              Word processing system files
  829.                C:\WP\                 Word processing data files
  830.                C:\WP\PLANNING\        Planning documents
  831.                C:\WP\MEMOS\           Memos
  832.                C:\WP\STANDARD\        Polocies and Procedures
  833.  
  834.            Use the following PSEARCH command to search for all documents
  835.            containing the text "emergency"...
  836.  
  837.                PS C:\WP\*.*/t:emergency/ds
  838.  
  839.            Only the word processing document files will be searched.
  840.            All other directories on your hard disk will be ignored.
  841.  
  842.      /EX   Exclude files.  Primarily intended for text search requests,
  843.            the exclude facility allows you to provide a list of pathname
  844.            and filename specifications that are to be excluded from
  845.            PSEARCH processing.  Since searching through data on your
  846.            hard disk requires extensive processing and disk read time,
  847.            excluding files from the process will save you time, and will
  848.            reduce the number of false matches displayed for your
  849.            requests.
  850.  
  851.            The most common files to exclude from text search processing
  852.            is product program and control files.  These files constitute
  853.            a large portion of your hard disk's used space and
  854.            unnecessarily lengthen the time it takes searches to locate
  855.            the desired data.
  856.  
  857.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 17
  858.      --------------------------------------------------------------------
  859.  
  860.            The exclude facility is implemented with two actions.  First,
  861.            you will need to create an exclude specification file and
  862.            place it in the same directory where PSEARCH is installed on
  863.            your hard disk.  This file will contain the names of all the
  864.            files and paths to be excluded.  You may specify DOS pattern
  865.            names to exclude groups of files with a single specification.
  866.  
  867.            Like DOS, use the '*' to indicate the last part of a filename
  868.            or filename extension may be any set of characters.  Also
  869.            like DOS, use the '?' to indicate that any single position of
  870.            a filename may be any character.
  871.  
  872.            In addition to DOS, two additional pattern features are
  873.            available.  You may place an '*' anywhere in the filename to
  874.            indicate any set of characters may exist in this point in the
  875.            name.  For pathnames, you may place an '**' at the end of a
  876.            directory path specification to indicate the specification
  877.            applies to the specified directory and all subordinate
  878.            directories.  Using '**', you can exclude an entire path with
  879.            a single specification.
  880.  
  881.            You must tell PSEARCH what you want selected for search, and
  882.            what you want excluded.  PSEARCH supports both of these, making
  883.            use of the SEL and EXC commands.  Placing a SEL in front of the
  884.            filename or pattern tells PSEARCH to select that file, while
  885.            putting an EXC tells PSEARCH to exclude it.  If nothing is
  886.            specified, PSEARCH assumes EXC.
  887.  
  888.  
  889.            Following are examples:
  890.  
  891.              1.    EXC *.EXE
  892.              2.    *.COM
  893.              3.    EXC TEST*.*
  894.              4.    EXC *TEST*.*
  895.              5.    EXC DO?FIX.*
  896.              6.    ESC PC*XX.*
  897.              7.    EXC C:\DOS\*.*
  898.              8.    EXC \TEST\*.*
  899.              9.    EXC D:\GAMES**\*.*
  900.              10    SEL TEST.XXX
  901.  
  902.            Explanations for the above examples:
  903.              1.  Excludes all filenames with the extension .EXE from
  904.                  processing.
  905.  
  906.              2.  Excludes all filenames ending with extension .COM.
  907.  
  908.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 18
  909.      --------------------------------------------------------------------
  910.  
  911.              3.  Excludes all filenames beginning with the letters
  912.                  "TEST" from processing.
  913.  
  914.              4.  Excludes all filenames having the characters "TEST"
  915.                  anywhere in the first portion of the filename.
  916.  
  917.              5.  Exclude files having 'DO' as the first 2 characters of
  918.                  the filename, and 'FIX' as the 4th, 5th, and 6th
  919.                  filename characters.  The 3rd character of the filename
  920.                  may be any character.
  921.  
  922.              6.  Exclude files having a name beginning with the 2
  923.                  characters PC and where the first portion of the
  924.                  filename ends with the characters 'XX'.  Any 0 to 4
  925.                  characters may exist between the 'PC' and 'XX' in the
  926.                  first portion of the filename.
  927.  
  928.              7.  Exclude all files from the DOS directory on drive C:.
  929.  
  930.              8.  Exclude all files from the TEST directory existing
  931.                  on any drive searched.
  932.  
  933.              9.  Exclude all files from the D:\GAMES\ directory and
  934.                  also exclude all files and directories subordinate
  935.                  to the GAMES directory.
  936.  
  937.              10. Even though all files containing the word TEST are
  938.                  excluded, using a SEL statment tells PSEARCH to search
  939.                  just that filename or pattern.
  940.  
  941.                 WARNING:  Do not combine SEL and EXC statements together.
  942.                 PSEARCH will find no matches if this is done.
  943.  
  944.            Exclude file names --
  945.  
  946.               Since you may want to exclude different files from
  947.               file find and text search requests, a different
  948.               exclude file name exists for each.
  949.  
  950.                  PSEARCHF.EXC  --  File Find exclude specifications
  951.                  PSEARCHT.EXC  --  Text Search exclude specifications
  952.  
  953.               These files may be created using most any word processor
  954.               or text editor.  If you have no word processor or editor
  955.               you may use the EDLIN text editor provided with your DOS
  956.               system.
  957.  
  958.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 19
  959.      --------------------------------------------------------------------
  960.  
  961.               The exclude files must exist in the same directory the
  962.               PS.EXE file is located on.  PS.EXE is the name of the
  963.               PSEARCH program file.
  964.  
  965.  
  966.  
  967.            Activating exclude --
  968.  
  969.               Exclude will only be functional when the /EX command
  970.               parameter is specified.  When /EX is specified, you must
  971.               have a valid exclude file.  PSEARCH will not continue
  972.               without one.  If you wish exclude to be active during all
  973.               executions, specify /EX as part of the PSEARCH= DOS
  974.               environment variable.  See later in the documentation for
  975.               a description of this feature.
  976.  
  977.  
  978.      /F    Find File in the current directory.  Normally PSEARCH will
  979.            search all directories to find a file.  Use the /F parameter
  980.            to limit PSEARCH to search only the specified or current
  981.            directory.
  982.  
  983.  
  984.      /FP   Find Prefix - (use with /T:) Indicates that matching text
  985.            must be at the end of an existing word.  Designed primarily
  986.            for word searches, find prefix qualifies the search to help
  987.            you find exactly the match you want.
  988.  
  989.  
  990.      /FS   Find Suffix - (use with /T:) Works like find prefix, except
  991.            finds the matching text only if it preceeds an existing word.
  992.  
  993.      /FW   Find Word - (use with /T:) The text to be searched for is a
  994.            word. Only select text that is a complete word. A word is
  995.            defined as any string of characters and numbers that is not
  996.            preceded or succeeded with other characters or numbers.
  997.  
  998.            In "This", "This" is a word. "is" is not a word.  A search
  999.            like    PS *.*/t:is/fw   would show matches for is but will
  1000.            not match on the "is" characters in "this".
  1001.  
  1002.  
  1003.      /HA   High Ascii characters will be shown in text search lines.     |
  1004.            Normally these characters are not useful and occur often      |
  1005.            as code in .EXE files.  They are ignored by PSEARCH.  Use     |
  1006.            /HA to cause PSEARCH to format and display them when they     |
  1007.            occur in matching lines being displayed.                      |
  1008.  
  1009.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 20
  1010.      --------------------------------------------------------------------
  1011.  
  1012.  
  1013.      /L    Line numbers.  When you are searching DOS text files for
  1014.            specific text (/T: parm used), use the /L parameter when you
  1015.            want PSEARCH to determine and display the number of the line
  1016.            associated with the text displayed.
  1017.  
  1018.  
  1019.  
  1020.            DOS text files are those files that have a carriage return
  1021.            and line feed at the end of each line of text.  A good
  1022.            example of these is DOS batch command files (*.BAT).  Word
  1023.            processing files often do not use this format and so line
  1024.            number specifications are not often useful for them.
  1025.  
  1026.  
  1027.      /N:nnn Newdays - Indicates that only files created or updated
  1028.            within the last nnn days are to be selected for processing.
  1029.            /N:1 causes any files updated within the last day to be
  1030.            selected. To search for files updated on the current date,
  1031.            specify /N:0.
  1032.  
  1033.  
  1034.      /ND   No Data.  For text searches, PSEARCH normally displays the
  1035.            text data lines for matching data found in files searched.
  1036.            If you only need the filenames shown, use the /ND parameter
  1037.            to deactivate the text display.
  1038.  
  1039.  
  1040.      /NM   No Multiples.  For text search specifications, causes
  1041.            PSEARCH to only search for a single matching text
  1042.            in any file and displays only one match.  Other matches
  1043.            may exist in the file.
  1044.  
  1045.  
  1046.      /NO   No mOre - Normally PSEARCH will stop at the end of each full
  1047.            display of lines.  You may press <ESCAPE> to terminate
  1048.            processing, <C> to disable more and display without stopping
  1049.            again, or press any other key to display another page of the
  1050.            display and stop again.  /NO disables this feature.
  1051.  
  1052.      /NM   Use of the /NM parameter will shorten your display of
  1053.            output and may improve search performance by stopping
  1054.            the search of a file after a single match is shown.
  1055.  
  1056.  
  1057.      /NW   No Windows.  PSEARCH normally operates in full screen
  1058.            window mode.  To deactivate this feature and DISplay all
  1059.            output in normal DOS line mode specify this parameter.
  1060.  
  1061.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 21
  1062.      --------------------------------------------------------------------
  1063.  
  1064.            The /NW parameter causes PSEARCH to use BIOS type screen
  1065.            writes to display output to the display.  The /NW parameter
  1066.            may be useful when you have special devices or TSR's
  1067.            active that screen or capture output going through these
  1068.            interfaces.
  1069.  
  1070.      /NP   Suppress ALL PSEARCH output.
  1071.  
  1072.  
  1073.  
  1074.  
  1075.      /O:nnn Olddays - Indicates that only files older than nnn days are
  1076.            to be selected for processing. /O:365 will cause files over
  1077.            one year old to be selected.
  1078.  
  1079.  
  1080.      /P    Pause - Pause  PSEARCH will pause whenever a match of
  1081.            filename or text in a file is found. You may terminate the
  1082.            search or continue by pressing any key.
  1083.  
  1084.  
  1085.      /PA   Print Append.  Works exactly like the /PF command except      |
  1086.            print data is appended to the previous PSPRINT.DAT file       |
  1087.            instead of overlaying it.                                     |
  1088.  
  1089.  
  1090.      /PF   Print to File - If you want to direct print to an output
  1091.            file, enter /PR. The file PSPRINT.DAT will be created in the
  1092.            current directory.  The resulting file may be edited or
  1093.            viewed using your current word processor, text editor, or the
  1094.            DOS TYPE command.
  1095.  
  1096.  
  1097.      /PR   PRint - Causes all screen output to also be directed to the
  1098.            output printer device.  This allows you to have a printed
  1099.            record of PSEARCH results.
  1100.  
  1101.  
  1102.      /R:nnn  Near specification for multiple text searches.  You may use
  1103.            the /R parameter when you have also specified multiple /T:
  1104.            parameters to cause PSEARCH to search for multiple sets of
  1105.            text.  /R specifies a number of characters that may exist
  1106.            between the first characters of the text to be searched.  In
  1107.            other words, the text will only be considered a match if it
  1108.            is within n characters of all other text specified.
  1109.  
  1110.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 22
  1111.      --------------------------------------------------------------------
  1112.  
  1113.            Use the /R when you want to find values related to one
  1114.            another and know the values will exist within close proximity
  1115.            of each other in the file.  The following example will search
  1116.            files for the name 'Jones' and will identify a letter to this
  1117.            person by indicating the search is only to search for the
  1118.            name 'jones' when it also exists near the letter salutation
  1119.            'Dear'.  The /R:50 value indicates the two values must be
  1120.            within 50 characters of each other in the file.
  1121.  
  1122.                 PS *.*/t:jones/t:near/r:50/ta
  1123.  
  1124.  
  1125.      /RT   Related text.  During text searches /RT will cause PSEARCH
  1126.            to attempt to display up to 10 lines of text related to the
  1127.            matching text being shown.  In many cases, less than 10
  1128.            lines of text may be shown when PSEARCH detects unprintable
  1129.            data or changes in paragraph structure.
  1130.  
  1131.            When /RT is specified, each display of matched text will be
  1132.            separated by horizontal bar lines to help you better see the
  1133.            groups of text being displayed.
  1134.  
  1135.  
  1136.      /S    System - Indicates that all directories on all hard disk
  1137.            drives are to be searched.  If a directory or drive is
  1138.            specified as part of the pathname, only it will be searched.
  1139.  
  1140.  
  1141.      /SO   Turns the PSEARCH signal sounds off.
  1142.  
  1143.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 23
  1144.      --------------------------------------------------------------------
  1145.  
  1146.  
  1147.      /T:text to be searched
  1148.            Text - Specifies the text to be found for text search
  1149.            requests. The text string may contain any characters. A
  1150.            terminating command line or the following slash character
  1151.            will signal the end of the text to be searched. If this is
  1152.            the last parameter on the command any trailing spaces will
  1153.            not be included in the search. To include trailing spaces,
  1154.            terminate the string with an ending slash character.
  1155.  
  1156.            Text may be specified in upper or lower case. Unless the /C
  1157.            parameter is specified to force exact text matches, the
  1158.            search will be made for any match regardless of case.
  1159.  
  1160.            Strings may also be single or double quoted. This allows for
  1161.            special characters to be included in the search string such
  1162.            as / characters.
  1163.  
  1164.            Examples:
  1165.  
  1166.             /T:BUDGET /T:Budget /T:Mr.  Jones/
  1167.             /T:"01/01/88"
  1168.  
  1169.            Note, to include a trailing space as part of search text, you
  1170.            must follow search text by another / command parameter. For
  1171.            example:
  1172.  
  1173.             PS *.C/T: SMITH /TA
  1174.  
  1175.  
  1176.            Up to five (5) /T: parameter specifications may be included
  1177.            for text search requests.  This allows PSEARCH to search for
  1178.            five different texts on a single search of a disk or
  1179.            directory. When multiple text is specified, consider the use
  1180.            of the /TA parameter to force PSEARCH to find all text in a
  1181.            single file before considering the file a match.
  1182.  
  1183.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 24
  1184.      --------------------------------------------------------------------
  1185.  
  1186.            To facilitate use in .BAT files, the /T: parameter may be     |
  1187.            specified without any search text.  In this case it will be   |
  1188.            ignored.  This allows batch file substitution to not fill     |
  1189.            in text words.  Note, the first /T: parameter must contain    |
  1190.            a valid search string.  The following is a valid command:     |
  1191.                                                                          |
  1192.                    Batch file command in FINDT.BAT:                      |
  1193.                         PS *.*/T:%1/T:%2/T:%3/T:%4/T:%5                  |
  1194.                                                                          |
  1195.                    Command entered:                                      |
  1196.                         FINDT JONES FRED                                 |
  1197.                                                                          |
  1198.                    Command generated:                                    |
  1199.                         PSEARCH /T:JONES/T:FRED/T:/T:/T:                 |
  1200.  
  1201.            The /T: parameter serves the purpose of indicating to PSEARCH
  1202.            of the search is to be for text in a file or for file names.
  1203.            Any command line execution of PSEARCH without the /T:
  1204.            parameter will cause PSEARCH to assume the request is to
  1205.            locate files by name only.
  1206.  
  1207.  
  1208.      /TA   Text 'AND'.  Used for mutiple text searches.  Indicates
  1209.            that all text must be found in the file for a PSEARCH
  1210.            to display a match.  Without /TA specified, any matching
  1211.            text will be displayed.
  1212.  
  1213.  
  1214.      /V    Immediate view of previous search output.  When /V is         |
  1215.            specified, PSEARCH will immediately display a scrollable      |
  1216.            list of the results of output from a previous PSEARCH         |
  1217.            command.  When View is exited, control will be returned to    |
  1218.            DOS.  Use the following command to start View:                |
  1219.                               PS /V                                      |
  1220.  
  1221.  
  1222.      /X:xxx eXecute - Build and execute a DOS command whenever a
  1223.            filename match or a text match is found. xxx is the DOS
  1224.            command to be executed.
  1225.  
  1226.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 25
  1227.      --------------------------------------------------------------------
  1228.  
  1229.            The command may either be a standard DOS command or the name
  1230.            of a DOS batch command file. The command will be executed
  1231.            with a second copy of COMMAND.COM. The command data may
  1232.            contain the following special characters to allow for
  1233.            substitution values.
  1234.  
  1235.               # - Always replaced with the selected filename
  1236.  
  1237.               & - Always replaced with the selected path/filename
  1238.  
  1239.               ! - Always replaced with the filename without extension
  1240.  
  1241.               @ - Replaced with a slash to allow for command parameters
  1242.                   to be specified in executed commands.
  1243.  
  1244.  
  1245.            Examples:
  1246.  
  1247.               /X:ERASE &To delete selected files
  1248.               /X:ARC A OLD123.ARC # To use ARC utility to archive
  1249.                                     file
  1250.               /X:TYPE & To type the file
  1251.               /X:LOTUS Start 123 for the file
  1252.  
  1253.  
  1254.      /XF:xxx eXecute File - Works like /X except that the command is not
  1255.            executed, it is generated and placed in a DOS batch command
  1256.            file named PSCMDS.BAT in the current directory. This file may
  1257.            be edited before it is executed.
  1258.  
  1259.  
  1260.      /XP:xxx eXecute with Pause - Functions in the same way as the /X
  1261.            parameter except that you are asked to indicate if the
  1262.            command is to be executed for each selected file.
  1263.  
  1264.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 26
  1265.      --------------------------------------------------------------------
  1266.  
  1267.      Specification of default parameters
  1268.      -----------------------------------
  1269.  
  1270.      Default parameters are parameters that do not need to be specified
  1271.      each time PSEARCH is started. Any PSEARCH parameter may be
  1272.      specified as a default parameter.
  1273.  
  1274.      Use the DOS SET command to specify the parameter name and contents
  1275.      to be used by PSEARCH each time it is started. The following
  1276.      example indicates the /EX exclude parameter specification is to be
  1277.      automatically provided to PSEARCH each time it is used in the
  1278.      command mode.
  1279.  
  1280.        SET PSEARCH=/D/M
  1281.  
  1282.      Once this DOS command is issued, each subsequent use of PSEARCH
  1283.      will operate as if these parameters have been specified on the
  1284.      command line. The SET command is most commonly placed in the
  1285.      AUTOEXEC.BAT file so it may be in effect every time your machine is
  1286.      started.
  1287.  
  1288.      Screen colors and monitor support
  1289.      ---------------------------------
  1290.  
  1291.      PSEARCH checks the DOS equipment flags to determine what type of
  1292.      monitor you have on your system. This is usually always correct
  1293.      except for one specific information. For those users running a
  1294.      composite monitor with a color graphics card, the screens may not
  1295.      be displayed correctly. If this occurs, use the DOS MODE command to
  1296.      set your environment to black and white. This can be done at system
  1297.      startup or just before starting PSEARCH. Beware that some
  1298.      applications incorrectly reset these indicators and they may need
  1299.      to be reset before again running PSEARCH. Following is an example,
  1300.      see the DOS reference for more information about setting the
  1301.      monitor with the MODE command.
  1302.  
  1303.         DOS MODE command example ===>  MODE BW80
  1304.  
  1305.  
  1306.      Pausing the Search
  1307.      ------------------
  1308.  
  1309.      Even if the Pause parameter is not specified, you may pause the
  1310.      search at any time by pressing any keyboard key. At the end of the
  1311.      next process PSEARCH will pause. You will then have the opportunity
  1312.      to continue processing, use a function key, or exit from PSEARCH.
  1313.  
  1314.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 27
  1315.      --------------------------------------------------------------------
  1316.                                                                          
  1317.  
  1318.      Program Maintenance History
  1319.      ---------------------------
  1320.  
  1321.      There is an ongoing commitment to improve PSEARCH as long as there
  1322.      is expressed need by PSEARCH users. I do respond to your requests.
  1323.      The enhancements below reflect both user requests and my own ideas.
  1324.      Please let me know of your needs, maybe they can appear on this
  1325.      list in the future.
  1326.  
  1327.      ------------------------------------------------------------------
  1328.  
  1329.      Version 1.0      March 1, 1986
  1330.           --  PSEARCH Version 1.0 was released in March 1st, 1986
  1331.  
  1332.  
  1333.  
  1334.      Version 2.0      April 8, 1986
  1335.           PSEARCH Version 2.0 was released April 8th, 1986. It
  1336.               upgraded version 1 with the following new features.
  1337.  
  1338.           -- Ability to search in .ARC files for filenames /AR /AO
  1339.           -- Find text by WORD, PREFIX, or SUFFIX /FW /FP /FS
  1340.           -- Returns back to menus after search is complete
  1341.           -- Extract data to file implemented
  1342.           -- Fix to show found text un upper/lower case
  1343.           -- /SO to turn sound off
  1344.           -- Ability to exclude .COM and .EXE files from search
  1345.           -- Ability to search all drives attached to system /DR:abc
  1346.  
  1347.      Version 3.0      September 7, 1986
  1348.           PSEARCH Version 3.0 was released Sept. 7th, 1986. It upgraded
  1349.           version 2 with the following new features.
  1350.  
  1351.           -- Sound alike and other new filespec wildcards (! ; ~).
  1352.           -- More menu options on the Peak menu.
  1353.           -- Correction to retrieve proper environment string to be used
  1354.              when executing DOS commands.
  1355.  
  1356.      Version 3.3      July 5, 1987
  1357.           -- Change registration so there is no longer a need to have
  1358.              the PSEARCH.REG file exist in the root directory.
  1359.  
  1360.           -- Text searches will not attempt to search .ARC files. Since
  1361.              these files are compressed it makes no sense to search them
  1362.              for text.
  1363.  
  1364.           -- Use environment field PS= to specify default command
  1365.              parameters.
  1366.  
  1367.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 28
  1368.      --------------------------------------------------------------------
  1369.  
  1370.      Version 3.4      September 16, 1987
  1371.  
  1372.           -- Ignore ~ ! and ; filename search characters unless they are
  1373.              in the first position of the filename. Previous versions
  1374.              file searches would fail if these characters were found in
  1375.              any position but the first.
  1376.  
  1377.           -- Correct filename matching. If file XXX would not be found
  1378.              if pattern name of XXX.* was specified.
  1379.  
  1380.           -- When print option was used with menus, when processing
  1381.              completed, menu text was printed to the printer. Corrected.
  1382.  
  1383.  
  1384.      Version 3.8      March 1, 1988
  1385.  
  1386.           -- Add ability to accept " or ' quoted strings in text search
  1387.              input command data. This is for the /T: parameter only.
  1388.  
  1389.  
  1390.  
  1391.      Version 4.0      February 22,1990
  1392.  
  1393.           This version is essentially a rewrite of the original PSEARCH
  1394.           facility.  All the changes are too numerous to mention.
  1395.           Following is a list of the most significant changes.
  1396.  
  1397.           Enhancements...
  1398.           -- Add ability to search up to 5 text strings
  1399.           -- AND/OR capability on text strings
  1400.           -- New exclude file allows user to specify file names
  1401.           -- New menu structure
  1402.           -- Near parameter to force multiple text matches to be within
  1403.              n characters of each other.
  1404.           -- /NW implements no window mode for those that need or prefer
  1405.              DOS style displays.
  1406.           -- /DS parameter allows a single directory path including all
  1407.              subordinate directories to be searched.
  1408.           -- The limit of the number of directories that can be searched
  1409.              greatly enhanced.  The maximum number of directories is
  1410.              related to the amount of free memory available to PSEARCH.
  1411.  
  1412.           Items removed...
  1413.           -- The Peak feature has been removed.
  1414.           -- The 5 text strings replaces the ability to specify a ?
  1415.              in the text search string.
  1416.           -- The exclude file replaces the /SK command to skip
  1417.              .COM and .EXE files.
  1418.  
  1419.      PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 29
  1420.      --------------------------------------------------------------------
  1421.      Version 4.1      February 26, 1990
  1422.           -- System lockup during speaker beeps.  Also improper beeps.
  1423.           -- Set sounds off as default
  1424.           -- Set pause at full screen (more) as default in command mode
  1425.  
  1426.      Version 4.2      March 9, 1990
  1427.           -- Added /RT parm to show related text
  1428.           -- Added field edit capabilities.
  1429.           -- Removed more line from display after user pressed a key
  1430.           -- Replaced /MO with /NO.  More was made default.
  1431.  
  1432.      Version 4.3      May 4, 1990
  1433.           -- Corrected errors encountered when processing .ZIP files
  1434.              containing directory names as well as filenames.
  1435.           -- Corrected problem where PSEARCH ignored the drive
  1436.              specification for the path to be searched.
  1437.           -- Added directory name to filename display on search display
  1438.           -- Added a screen of condensed help.
  1439.           -- Improved screen I/O performance
  1440.           -- Removed requirement to place quotes around text to be
  1441.              searched for in command line.  You may now search for
  1442.              data containing spaces.
  1443.                  PS *.TXT/T:Joe Doe
  1444.  
  1445.  
  1446.           -- File find now searches all hard disk drives unless a
  1447.              specific drive is specified.
  1448.           -- /S parameter causes all hard disk drives to be scanned
  1449.              unless a specific drive is specified in the supplied
  1450.              pathname.
  1451.  
  1452.      Version 4.4a     July 11, 1990
  1453.           -- When PS *.exe/DS used.  The same directory was searched
  1454.              3 times.  This only happened when directory had no
  1455.              subdirectories.  PS was fixed to scan the directory once.
  1456.           -- For network operation  -- added auto skipping of any files
  1457.              DOS denied access to.  A message is printed for each file
  1458.              that is bypassed.
  1459.           -- Detect bad exclude file specifications and stop processing.
  1460.              Processing used to continue but not select any files.
  1461.           -- PSEARCH was searching all directories for a file even when
  1462.              a specific pathname was specified.  The search is now
  1463.              limited to just the specified pathname.
  1464.           -- Support multiple drive parameter (/DR:) when directory name
  1465.              specified.  Allows multiple drives to be searched for a
  1466.              single directory name.
  1467.           -- PS *.* /AT:u stopped displaying output when readonly,
  1468.              hidden, system, updated file displayed.
  1469.           -- Added [=blank and ]=\ to /X: command substitution
  1470.  
  1471.         PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 30
  1472.         --------------------------------------------------------------------
  1473.      Version 4.4c  December 17, 1990
  1474.           -- Added capability to specify a list of files to be searched
  1475.              on the command line using the "@" symbol.
  1476.           -- Added the /NP (No Print) parameter
  1477.           -- Enhanced the .EXC file to be able to process SELect and EXClude
  1478.              statements.
  1479.      Version 4.4D
  1480.           -- Fixed problem with registration info not displayed.
  1481.      Version 4.4E
  1482.           -- When PSEARCH.DAT found during file search IN ARCHIVES,
  1483.              program locked up.
  1484.           -- /X: parm did not work in /NW mode.  DOS returned Bad command
  1485.              or filename.
  1486.           -- A couple little comsmetics.
  1487.           -- If a corrupted .ZIP file was encounterd, PS crashed.  Now skips
  1488.              the file.
  1489.  
  1490.      Version 5.0                                                         |
  1491.           -- Added /PA to append to the PSPRINT.DAT                      |
  1492.           -- Added scroll back feature                                   |
  1493.           -- Added View feature to menu.  View prev scroll back          |
  1494.           -- Added text and WordPerfect file viewers.  Press enter       |
  1495.              when scroll bar is within a file on the scroll display.     |
  1496.           -- Added evaluation day message pregmsg() in pmregis.c         |
  1497.           -- Allow empty search strings for batch file use               |
  1498.                     Can have command PS /T:word/T:/T:                    |
  1499.           -- \ characters was not considered printable. Added \\.        |
  1500.           -- Change PSEARCH.DAT to PS.DAT                                |
  1501.           -- Default to "more" off in menus. Due to scroll back option   |
  1502.           -- Added /HA parameter to display hi-ascii chars               |
  1503.           -- Directories now searched in alphabetical order              |
  1504.           -- You may now specify incomplete pathnames such as C\*.*      |
  1505.              It is assumed C is a directory subordinate to the current   |
  1506.              directory.                                                  |
  1507.  
  1508.         PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 31
  1509.         --------------------------------------------------------------------
  1510.  
  1511.         Registering The Utilities
  1512.         -------------------------
  1513.  
  1514.         PSEARCH is distributed under the Shareware concept. This allows
  1515.         users to evaluate software for a short time to determine if it
  1516.         is useful to them.  If you decide the software is of value to
  1517.         you and decide to keep and use, you are required to register it.
  1518.  
  1519.         This concept allows for quality software to be distributed at a
  1520.         reasonable cost.  Hundreds of hours of my time has been invested
  1521.         in PSEARCH.  Continued registration will justify the continued
  1522.         upgrading of this utility to insure it remains up to date with
  1523.         current technology.  In any case, I do greatly appreciate all
  1524.         users that care enough to register.  I try to provide the best
  1525.         possible software for all you faithful supporting users.
  1526.  
  1527.  
  1528.         You may use the order form in ORDER.FRM when registering.
  1529.  
  1530.         Send registration requests to:
  1531.  
  1532.                   Patri-Soft
  1533.                   5225 Canyon Crest Drive
  1534.                   Suite 71-358
  1535.                   Riverside, CA   92507
  1536.  
  1537.         The registration charge is a one time fee that entitles you to
  1538.         all future versions of the product.  These may either be
  1539.         obtained from normal Shareware sources or from me.  I do not
  1540.         automatically  send product updates to registered users.  It is
  1541.         impossible to provide automatic upgrades at the low costs of
  1542.         these utilities.  If you would like to receive the next version
  1543.         of the software, add an additional $15 to your order and
  1544.         indicate on the order form you wish to receive the next update
  1545.         version.  You will be sent the next version along with an
  1546.         optional order form to request subsequent releases.
  1547.  
  1548.    Site licensing plans for one or more Patriquin utilities:
  1549.    ---------------------------------------------------------
  1550.          Only $495.  Please see SITELICE.DOC
  1551.  
  1552.         PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 32
  1553.         --------------------------------------------------------------------
  1554.  
  1555.         VISA / Mastercard / Telephone Registration
  1556.         ------------------------------------------
  1557.  
  1558.         You may place a telephone order for the utilities using your credit
  1559.         card by calling Nelson Ford's Public (Software) Library.
  1560.  
  1561.              Telephone orders: 800-242-4775 or 713-665-7017
  1562.  
  1563.         The  PSL  supplies Shareware  software  at  a nominal  cost  to its
  1564.         customers.  Consider them for all your Shareware needs.
  1565.                              ----     OR    ------
  1566.         You may call the Patri-Soft BBS and register online.  The number
  1567.         is (714) 352-2825 1200/14000 8-N-1.  Fill out script 2 to place
  1568.         your order.  Credit card orders are also accepted through U.S. Mail.
  1569.  
  1570.  
  1571.          REGISTRATION
  1572.          ------------
  1573.  
  1574.          Patri-Soft provides full support to users, both registered and
  1575.          non-registered.  We provide support through several different way:
  1576.  
  1577.                  U.S. Mail  -  You may send us problem reports through
  1578.                                the mail. Any extended information that
  1579.                                you can provide is greatly appreciated.
  1580.                                (i.e. screen shots, the actual problem
  1581.                                file, etc).
  1582.  
  1583.                  Telephone  -  You may contact us at (714) 352-2820 to
  1584.                                discuss problems.  However, extended
  1585.                                telephone support may be limited as the
  1586.                                circumstances require.
  1587.  
  1588.                  CIS        -  You may contact us on CompuServe
  1589.                                (76347,2477).  This is usually the
  1590.                                fastest way.
  1591.  
  1592.                  FAX        -  You may FAX us problem reports and
  1593.                                orders at (714) 352-1527.
  1594.  
  1595.         PSEARCH Users Guide/Reference    Copyright 1991 Patri-Soft   Page 32
  1596.         --------------------------------------------------------------------
  1597.  
  1598.         A BBS is in operation 24 hours a day to take your enhancement
  1599.         requests and problem reports.  The number for this is (714)
  1600.         352-2825.  (1200/14000 8-N-1).  Extended access is provided to
  1601.         registered users of the utilities.
  1602.  
  1603.         Patri-Soft offers a money back guarrentee if you are not
  1604.         satisfied with the software.  Simply contact us with the reasons
  1605.         of your dissatisfaction, and we will gladly refund your money.
  1606.  
  1607.         We at Patri-Soft pride ourself on our user support.  If for some
  1608.         reason you feel that you have not gotten the service you
  1609.         deserve, PLEASE let us know.  We try to respond to ALL users
  1610.         quickly and politely.
  1611.  
  1612.  
  1613.